Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Preferred Movie Settings

SetMoviePreferredRate

The SetMoviePreferredRate function allows your application to specify a movie's default playback rate.

pascal void SetMoviePreferredRate (Movie theMovie, Fixed rate);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

rate

Specifies the new movie rate as a 32-bit, fixed-point number. Positive integers indicate forward rates and negative integers indicate reverse rates.

DESCRIPTION

The default playback rate is the rate that the StartMovie function (described on page 2-98) uses when it starts playing a movie. The default preferred rate of a movie is set to 1.0 (the kFix1 constant) when the movie is created.

SPECIAL CONSIDERATIONS

Do not set the preferred rate to 0.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

Your application can obtain the preferred playback rate by calling the GetMoviePreferredRate function, which is described in the next section.

You can set the current playback rate of a movie by calling the SetMovieRate function, which is described on page 2-172.